home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / flicit25.zip / FLICIT.DOC < prev    next >
Text File  |  1994-04-07  |  12KB  |  315 lines
  1.          FFFFFFF LL       IIIIIIII  CCCCCCC IIIIIIII TTTTTTTT 
  2.         FFFFFFFF LL       IIIIIIII CCCCCCCC IIIIIIII TTTTTTTT 
  3.         FF       LL          II    CC          II       TT    
  4.         FF       LL          II    CC          II       TT      
  5.         FFFFF    LL          II    CC          II       TT      
  6.         FFFFF    LL          II    CC          II       TT     Version 2.5
  7.         FF       LL          II    CC          II       TT     (shareware)
  8.         FF       LL          II    CC          II       TT      
  9.         FF       LLLLLLLL IIIIIIII CCCCCCCC IIIIIIII    TT    
  10.         FF        LLLLLLL IIIIIIII  CCCCCCC IIIIIIII    TT    
  11.  
  12.  
  13.  
  14.    FLICIT V2.5  - Mar, 1994   Copyright (C) 1993,1994 Andrew W. Baucom
  15.  
  16.  
  17.                       **** Distribute Freely ****
  18.  
  19. Flicit is a powerful program for creating Autodesk Animator Flic (.FLC) files
  20. from either GIF or TGA images or a combination of both.  
  21.  
  22.  
  23. ================================================================================
  24. This version of Flicit is shareware and has the following limitations:
  25.  
  26.  1) output flics are limited to 320x200 (input images can be bigger).
  27.  2) 30 frame limit
  28.  3) no background image capability
  29.  
  30. If you like this program and find it useful, you may register and get a
  31. version, without the above limitations, by sending:
  32.  
  33.  $45 (U.S.) for a single user version or
  34. $199 (U.S.) for a 10 user site to:
  35.  
  36. Andrew Baucom, 8605 Imperial Drive, Laurel, MD 20708
  37. (301)317-5726 or (301)572-1327, email: abaucom@fester.swales.com
  38.  
  39. (UNIX versions of Flicit are also available)
  40.  
  41. ================================================================================
  42. Files:
  43.  
  44.  
  45.  flicit.exe   - Flicit program for creating .FLC files
  46.  
  47.  flicit.doc   - This document
  48.  
  49.  flicex.exe   - A bonus program for exploding .FLC's into individual GIF/TGA
  50.                 images.  (see flicex usage command)
  51.  
  52.  dos4gw.exe   - Rational DOS4GW 32-bit DOS extender.  Make sure that this
  53.                 file is somewhere in your DOS PATH when you run flicit.exe
  54.                 or flicex.exe
  55.  
  56. ================================================================================
  57. Requirements:
  58.  
  59.  1) 386/486 class PC.  Flicit uses the DOS4GW 32-bit DOS extender.
  60.  
  61.  2) 2+ megs of RAM.  The bigger the images, the more memory it will need.
  62.  
  63.  3) Some sort of FLC player.  (this is not really a requirement)
  64.     There are a number of public domain FLC players.  The Autodesk Animator
  65.     Pro Player is a good one.  There is also a MS-Windows Version.
  66.  
  67. ================================================================================
  68. Features:
  69.  
  70.  1) Works with GIF and/or TGA images.
  71.  
  72.  2) Automatically quantizes 16 and 24 bit color TGA images down to 256 color.
  73.  
  74.  3) GIF palettes need not be identical, Flicit can combine and compute the
  75.     best palette to use.
  76.  
  77.  4) Add a background image to the flic.
  78.  
  79.  5) Ping, builds flic forward and then backward, 1 --> N --> 1.
  80.  
  81.  6) Able to reduce NTSC/PAL "hot" colors to acceptable levels.
  82.  
  83.  7) Select a percentage of the image palettes to random sample for computing
  84.     the best final palette to use.  This saves alot of time if there are alot
  85.     of frames.
  86.  
  87.  8) Allows text overlays in regular text size or double width/height size.
  88.     You can also include changing numerical values in the text overlay
  89.     string.  This is helpful for adding a timestamp to each frame.
  90.  
  91.  9) Allows the use of wildcards on the command line for specifying image file
  92.     names.  Not the cruddy DOS wildcards, but real UNIX like!!!
  93.  
  94. 10) All image file named are sorted canonically to determine the order in
  95.     which the images are to be assembled.
  96.  
  97. 11) Fastest flic builder and best color quantization I've seen yet...
  98.  
  99.  
  100. ================================================================================
  101. Caveats: (You knew there had to be some...)
  102.  
  103.  1) All the images must be the same size (width x height).
  104.  
  105.  2) GIF images must be 256 color.
  106.  
  107.  3) Text overlays are made using the brightest R+G+B combination found in
  108.     the final palette, so text overlays will disapear if overlayed on any part
  109.     of the image where that brightest color occurs.
  110.  
  111.  4) The background image can be a different size from the frames but will
  112.     always be placed starting in the upper left corner of the frames and
  113.     clipped to the size of the frames if it is bigger.
  114.  
  115.  5) Requires a few megs of memory, the bigger the images the more it needs.
  116.  
  117.  
  118. ================================================================================
  119. Usage:  flicit.exe
  120.  
  121.  
  122. -@ <file>     = Loads all switches and info from a script file see below
  123.                 for a sample script file.
  124.  
  125. -o <file>     = output flic file name to create. A .FLC extension will be
  126.                 appended if no extension is specified
  127.  
  128. -q            = quiet flag, this suppresses all text output
  129.  
  130. -i            = ping flag, this builds the all the frames into the flic
  131.                 forward and then reverses the order of the frames and adds
  132.                 them to the flic.  This gives a ping pong effect.
  133.  
  134. -v <1|2>      = turns NTSC/PAL hot spot checking. -v1 for NTSC, -v2 for PAL
  135.  
  136. -c <image>    = use <image> as a background image for the flic. 
  137.  
  138. -r <#>        = used with the background image to control the RED threshold
  139.                 to use when deciding whether to display background pixels or
  140.                 forground pixels.  ie. -r0 -g0 -b0 specifies that background
  141.                 pixels will show through only where the foreground pixels are
  142.                 black.  Values can be 0-255.
  143.  
  144. -g <#>        = GREEN threshold.  Values can be 0-255.
  145.  
  146. -b <#>        = BLUE threshold.  Values can be 0-255.
  147.  
  148. -d <#>        = Time delay in milliseconds between frames. This is used during
  149.                 flic animation playback.
  150.  
  151. -k <#>        = Quantize colors down to # colors. ie. -k64 will result in a
  152.                 flic with only 64 colors.  .FLC's are limited to 256 colors
  153.                 max.
  154.  
  155. -z <%>        = Percentage of image palettes to random sample before computing
  156.                 final palette for flic. Value can be 1-100.
  157.  
  158. -p <file>     = Load final palette from file.  This file is simple a 768 byte
  159.                 file containing RGB triplets and will be used as the palette
  160.                 for all frames in the flic.
  161.  
  162. -s <file>     = Save the final palette computed by Flicit in file.
  163.  
  164. -t <string>   = Text overlay string to be placed in image.
  165.  
  166.           <string> must have the format:
  167.  
  168.           "<x coord>,<y coord>,<text>,<size>,<start>,<delta>"
  169.  
  170.  
  171.            <x coord> = X coord for upper left corner of text string.
  172.            <y coord> = Y coord for upper left corner of text string.
  173.            <text>    = text string to display in single apostrophes 'text'.
  174.            <size>    = the keyword NORMAL or DOUBLE for normal or double size
  175.                        text.
  176.            <start>   = starting floating point number to place in string where
  177.                        there is a %w.pf 'C' style format for floating point
  178.                        numbers.
  179.            <delta>   = delta frame floating point increment number.
  180.  
  181.            examples:
  182.  
  183.             1)  -t "10,10,'this is a test',DOUBLE"
  184.  
  185.                  will display the text "this is a test" at image coordinates
  186.                  10,10 in double size text.
  187.  
  188.             2)  -t "10,10,'T-minus %4.2f seconds to liftoff',NORMAL,20.0,-0.5"
  189.  
  190.                  will display the text:
  191.  
  192.                   "T-minus 20.00 seconds to liftoff" on frame 1 of flic
  193.                   "T-minus 19.50 seconds to liftoff" on frame 2 of flic
  194.                   "T-minus 19.00 seconds to liftoff" on frame 3 of flic
  195.                   "T-minus 18.50 seconds to liftoff" on frame 4 of flic
  196.                   etc.
  197.  
  198.                  at image coordinates 10,10 in normal size text characters.
  199.  
  200.             3)  -t "@text.txt"
  201.  
  202.                 will load all "-t strings" from the file text.txt.  The
  203.                 contents of text.txt may look like:
  204.  
  205.                 # this would be a comment line
  206.                 10,10,'this is a test',DOUBLE
  207.         10,20,'this is a another test',DOUBLE
  208.                 10,300,'%.5f seconds',NORMAL,1.0,0.025
  209.  
  210.  
  211. ================================================================================
  212. Script:
  213.  
  214. The following is a sample movie.txt file that contains all the possible
  215. switches for Flicit.  This file would be used with the -@ switch when
  216. running Flicit.  All the Flicit options will then be set from the info in
  217. this file.  This makes it easy to configure Flicit as a backend program.
  218.  
  219.  
  220. # <file starts here>
  221. #
  222. # FLICIT MOVIE MAKING SCRIPT FILE
  223. # Andrew Baucom (Nov 1993)
  224. #
  225. # this file contains all possible options for the flicit utility.  you
  226. # should leave all these lines in here and comment out the ones you don't
  227. # need so that you can easily see what is available.
  228. #
  229. #
  230. [options]            # general flic options section
  231.  
  232. ping    = true            # ping frames 1--> N--> 1 <TRUE|FALSE>
  233. #ping     = false        # ping frames 1--> N--> 1 <TRUE|FALSE>
  234. quiet    = FALSE        # quiet <TRUE|FALSE>
  235. quantize = true            # quantize colors <TRUE|FALSE>
  236. delay    = 50            # frame delay in milliseconds
  237. sample_palettes = 30        # % of palettes to sample
  238. output_flc = \tmp\foo.flc        # output flic name
  239. #input_palette  = foo.pal    # use input palette for flic
  240. #output_palette = fee.pal    # write final flic palette to file
  241.  
  242.  
  243. [tv]                # Television color reduction section
  244.  
  245. type        = NTSC           # tv type color reduction <NTSC | PAL | NONE>
  246. method      = REDUCE_SAT    # method=<REDUCE_SATuration | REDUCE_LUMinence>
  247. hot_black   = FALSE        # TRUE=(hot=black)  FALSE=(hot=safe)
  248. pedestal    = 7.5           # pedestal value
  249. gamma       = 2.2           # gamma value
  250. chroma_lim  = 50.0        # chroma limit
  251. compos_lim  = 110.0        # compos limit
  252.  
  253. #type       = PAL           # tv type color reduction <NTSC | PAL | NONE>
  254. #method     = REDUCE_SAT    # method=<REDUCE_SAT | REDUCE_LUM>
  255. #hot_black  = TRUE        # TRUE=(hot=black)  FALSE=(hot=safe)
  256. #pedestal   = 0.0           # pedestal value
  257. #gamma      = 2.8           # gamma value
  258. #chroma_lim = 50.0        # chroma limit
  259. #compos_lim = 110.0        # compos limit
  260.  
  261.  
  262. [text_overlays]            # text overlays section
  263.  
  264. #text = x,y,"text string",DOUBLE,start,delta
  265.  
  266. text = 10,10,"This is a test",DOUBLE
  267. text = 20,20,"T-minus %5.2f seconds to launch",NORMAL,10.0,-0.25
  268.  
  269.  
  270. [frames]            # file specifications of flic frames section
  271.  
  272. file = c:\tmp\*.gif        # frame file spec
  273. file = c:\tmp\*.tga        # frame file spec
  274.  
  275. #file = c:\tmp\*.gif        # frame file spec
  276. #file = c:\tmp\*.gif        # frame file spec
  277.  
  278.  
  279. [background]            # background image section
  280.  
  281. #file = c:\tmp\earth.tga        # background image
  282. #red_threshold = 0        # background transparency for red
  283. #green_threshold = 0        # background transparency for green
  284. #blue_threshold = 0        # background transparency for blue
  285.  
  286. # <file ends here>
  287.  
  288. ================================================================================
  289. The author can be reached at:
  290.  
  291. Andrew W. Baucom
  292. 8605 Imperial Drive
  293. Laurel, MD 20708
  294.  
  295. abaucom@fester.swales.com (192.111.253.6)
  296.  
  297. (301)317-5726 or (301)572-1327
  298.  
  299. (UNIX versions of Flicit are also available)
  300.  
  301. ================================================================================
  302. History:
  303.  
  304. V1.1 - V1.8  - initial development
  305. V1.9         - added switch -d# for frame delay in flc (milliseconds)
  306. V2.0         - added -i ping capability
  307. V2.1         - restructured code...
  308. V2.2         - added -c background image
  309. V2.3         - added tv NTSC/PAL color reduction & scripting option
  310. V2.4         - recoded to automatically detect gif/tga
  311. V2.5         - Fixed TGA compressed algorithm
  312.  
  313.  
  314. Enjoy!
  315.